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1.0 General Deseription 


Fackeagineg Tnformation 


The XEFSO package consists of the following parts? 


Le Qwners Maruael 

2. RCA type video cable assembly 
3. KXEFSO System Diskette 

4. Warranky Card 

Se XEFGO Unit 

&- Two End Caps 

7. Fower Adapter - 2600 Came Type 
8. Box for Fower Acaeptear 

9. Gift Box 


Statistics 
XEPGO Current Draw 400m 
Fower Supply So0mAa ¢Y¥ DC 
Fhysieal Dimensions ~ 40mmH 240ml L42mmW 
Video Qubput - NTSC Compogite Manachrame 
Video Displayt 

Text ~- 80 columns by 25 lines 

Graphies ~ G20 dote by 200 lines 
Farallel Fort: 


Fin information ~- 8 date bits, atrobe, busy, 
Connector - DEZS female 
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2.0 Fryugsical Interface 


The Joystick port will use two lines for interfacing. One FIA line for 
input from the XEFSO anc one FIA line for output to XEFSO. Both the XEPSO 
and computer will share @ common ground line. Either joystick port ¢1 or 
2) may be used with the supplied software. 


MALE CXE/XL/800/400)0 COMMUNICATION FORT FIN CONFIGURATIONS ¢ 


JOYSTICK 1 JOYSTICK 2 


al eg ca ana aaa <a aa Ca? 


PCN FUNC TION 


1 Dabe bo KEFSO 

z Daebe from KXEFOGO 
ge? Not Used 

3 Common Grower 
eo Not Used 
Lo Daebe bo KEFOGO 
Li Dabe from KEFSO 
Lan 1é Not Used 
L? Common Growrid 
18 Not Used 


PEMALE OCXEPS0) PARALLEL PRINTER FORT PION CONFIGURATION: 


\N 25 24 23 22 21 20 19 18 17 16 15 14 / 


PCN FUNC TION 


1 Strobe 

gn Farallel Date 
Lo Not Used 

Li EH ty 

Land? Not Used 
18-25 Gr oui 
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3.0 Software Trnterfece 
3.1 General Deseription 


Tne softwere interface to the KEFSO on the 8 bit computer side 
is a disk booted handler. This handler replaces the Et, St, amd Fo 
veoebore in the Handler Accdress Table (831A). 

Loading of the hancdler is as follows: A DOS disk containing the 
handler must be in drive i. The computer is powered om, causing a@ 
disk boot. The DOS is loaded in and initial: > The POS init code 
looks for the file AUTORUN. SYS on the boot disk anced loads it. The 
XEP SO handler must be mamecd AUTORUN.SYS to be loaded at boot time. 

The handler file is loaded into RAM at acdress $3000 and conmbinuwine 
Upward approximately 1.5K butes. 

The file consists of a relocater portion followed by the actual 
XEF SO handler. After the file is in memory, DOS causes the in: code 
of the handler to execute. This init code is the relocater which 
uses a variable called MEMTOP C#2ES,2E46) to fined the last address 
of uger Cnonme-system)? RAM. MEMTOFP is then decremented by the relocater 
to point to an address about 1.5K below ite old value. This will make 
room for the handler portion to be moved to those addres pe 6 This 
address space into which the handler will be loaded is just below the 
noreal sereen RAM and display list address space. 

While the relocater moves the handler to its proper location, it 
resolves all absolute acdress references within the handler code. Thus 
the handler code comes from disk in a relocating format (see Appendix 
Bo. After the handler has been moved, the relocater sets the DOSINT 
veebor €$00) to point to the handler init code, sets an address within 
the handler to point to the old DOSINT code, then jumps to the handler 
imit code. 

The handler init sequence sets up the FIA registers to communicate 
to tne KEFPSO, modifie the Handler Address Table (CHATABS #314), sets 
MGW SOreen wMaeragims., amd determines whether the system is NTSC ¢460 Hu 
or FAL ¢30 Hed. Ab this poimh the init code checks the position of the 
SHIFT key. If the key is pressed the code leaves the 40 column screen 
on and exits. If the key is mot pressed the code then disables the ANTIC 
chip from display so that XEFPBO T/0 can beain. 

The handler mow exits back to DOS, which then exits back to the 
OS, whien then decid Which application to rum (for example the BASTC 
cartridge) and jumps to that code. As long as the application makes 
T/0O calls for the sereen and printer through the mormal OS ClO calline 
conventions, the XEPBO handler will intercept them anc pass data on 
to tne KEFSO device. 


pes 


ue 


ae 


Fage & 


o 


3.2 Funetional Bescription 
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3.2.6.1 Sereen Operations 


The handler will monitor and communicate the following locations 
to the XEPSO0 and will update them if the XEPSO causes &@ chanee? 


sition COLCRS Clow buted 
ition ¢hiehd for ranee checkimne 
ition ROWCRS 


BOSS Cursor kK 
BOSS Cursor 
$OS4 Cursor ¥ 


The following locations will be monitored and communicated 
to the XEPSO? 
DeaPault: Optional? 


List Flag DSFFI tpeceoteeoeeoe HOO COFFD $OU COND 
Cursor On/Off Flag Cr INH eee $00 : $OL COFFS 
Cursor Left Margin LM aoe $OOD } RX CANYS 
$OSS Cursor Right Margin F ARGN oo BAF } $RX CANYS 
AF 4 Chareober Ease CHEAS «24222226 HED at iat ae $OO COM 
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AF 
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The following locations will be monitored and aeted upon ty 


tie handler to emulate screen editor operations? 


BEEF Start/Stop Screen Gubtput Flas 
¥Y Reg EQF Stbatbus CONTL 3 Keystroke?) ame BREAK Kes 


Logical lines of text on the sereen may encompass more than one 
physical line. The lenath of each physical line within a logical line 
is determined by the left and right mareins. Up to 24 physical lines 
may be included within one logical line. 


Tebe ere seb et 2,7,15,23,31,39,47,55,63,71.79,87%.95,1035,1.11,119, 
127,155,145 ,151,159,167,175 189,191,199, 207,215,223, 2391,299,.247, 255. 
These are the default settbines and may be chaneed with the set ane 
clear tab control characters. Tab values only apply to physical lines, 
thus oe logical line of two or more physical lines will have its tab 
aLops repeated on each physical line. 


The 40 column ANTIC sereen may be enabled with & command in the 
event the user wishes color graphics, 40 column text, or nas mo 80 
column monitor. The parallel printer is still operational in this moce, 


Graphics is enaeblec by @ special OF EN commancd to "Si". In this mode 
Lhe sereen is 320 dots (40 bytes) by 200 lines The cursor will be in 
the upper left hand corner of the screen awaiting data transfer. 
character gent to the XEF SO will be displayed in sequence? all 
Will correspond to consecutive dots across a scan line. The MSE 
be displayed first ame the ois last. 


The status line is Y cursor value #24. This line may be used for 
inmpuk or output, however control characters do mot edit, but only print 
im this line. One control is allowed, SHIFT DELETE. The line does mot 
scroll. Be careful mot to aceidentily FOSTTION or FOKE the cursor inte 
this line while the BASIC command line processor is achive as it may 
require uge of the Reset key to recover from @ lockup that can oceur 
on this line. 
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3.262 Printer Operations 


The XEFSO will also output single characters to the printer port 
tLirough @ 2K internal buffer. Data presented to the printer by the handler 
May be interpreted im one of three ways? 


No Translation ~ All & date bite of character information will be 
passed to tine printer port. 


Light Translation ~- ATASCIN EQL ¢$96) is translated by the printer 
handler to the CR and LP characters before trangamission to the printer. 
This is the default printer mode. Optionalle, only the CR may be sent for 
EOL. + 


Heave Translation - Lieht translation plus ASOXT characters below #20 
will be translated to @ "“" character ¢for CONTROL? followed by the 
carrespoanding letter before being sent to the printer. The MSE will be set 
to 0. 


The printer oubput may be directed to either the KXEPSO0 (parallel) or 
serial ports or both. The unit mumber (guch a8 PS) may be kept or altered 
depending upon the meecd. See chart below. 


Calle to "RPE" 


Oper Assian printer hancler to TOCE GN anc issue status 
request bo printer. AUXI must be 08 (Write onmls. 

Close unassien handler from TOCE dN 

Get Char Nob supported 

Fark Char Send oo character to the printer port 

Geb Status Reburns status of printer BUSY line, l=available, 
LaS2busy or off line. 

Special Configure printers anc select translate mode (see 
chart below). Bo before OFEN to printer. 


Fage 9 


ity 


Special Configurati 


Configuration Byte 
of sees of eee of sees of eee fe eee of eee of sees oe wee oo 


I7ISI S14 are; 10] 
dpe eee edpe snee adhe cone eihe cnne edhe ease edhe sees edhe see edhe nee athe 


1 
x 
x 
HK 


Comfiqurati 
0 
0 
0 
0 
0 


0 
0 


Note - FS 
tie handler 


binroudan 


+ 
+ 


on Command to F 


Agssiannents for AU 


Bit positions 


Parallel 
erial 
erial 
Serial 
Reger vec 

eed Parallel 
Regerved 

at 


t 
‘ 
t 
‘ 
t 


“% 
3 
“% 
2 
a 


Agssiannents for AU 


Lien 


No translation 


ager vec 
Light 
No tranalaet: 
Heavy 


Reserved 
it 


ae 


PLS are mot 


Faae 


Comearicd 


XL 


Fort 


Fort 
Fort 
Fort 


3 1) 
3 


3 1 


Fort 


Xe 


translation 
translation 
translation 


translation 


alterable 
and are directed only aver 


Lo 


+ 
$ 


tine 


Dy be 


bo 
bo 
bo 


bo 


Lines 


serial 


adh LF 


CR ALE 


ae 


Tema dr 


ELIS o 


unaffected 


4.0 Communications Trterfece 
4.1 Communication Fundamentals 


Communication with the XEPSO will be handled by sending serialized 
Gabe over bit O or 4 ¢J0OY0,J0Y1) and receiving serialized data over bit 
Lor 8 (J0OY0,J0¥1) of the FIA A I/O register. Data will be shifted at 
LS.7KE. Transmitted and received date will each contain 9 bits of infor 
mation .« Date will be shifted out es follows! a start bit of value zero, 
followed by bits DO through BY, followed mext by a control bit to indicate 
whebner date €09 or command C1) information has been sent, then terminated 
with 8 stop bit of value di. Currently the supplied handler will provide 
date shifting on the computer end. Any applications that do mot use the 
handler or drive the xX 30 eb oe different baud rate must provide code for 
thie. Tb must be understood that this code is time critical in operation, 
ao all 4502/ANTIC eyoles must be accounted for during data shifbine. 


An alternate transmit/receive mode, “burst mode", allows faster transmit 
Limes. The XEF S80 to computer data line (receive lined is : C1) when 
characters may be sent and it is a low (€0) when the XEPSO Daisy. Thi 
mo curgar informatbion s reburnecd. This mode applies only to characters to 
be gseamt to the sereen Cineludine control characters) and characters sent 
to the printer ¢the only mode for the printerd. Burst mode does mot apply to 
commands of arey sort. 


Ary custom handler that sets buret mode must be aware of how to hancle 
comeunicatbion from that point. 

Whem wedbing for @ cursor or characber Crom burst modded monitor the 
dabe-in line immediately after transmitting & bute. 

When im burst mode wait at least 90 usec before testing the data-in 
line for 0 Cbuey) or do (reads). 

Do mot allow any 465902 interrupts when transmitting or receiving the 
serializecd date, as this will modify the baud rate biminas. 

Interrupts may be allowed while waiting for the XEFSO to eo ready - 
buret mode. Thus other inberrupt driven processes such as a modem handler 
will mot lose characters. 
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Faae 


4,5.0 Get Cnerecter Command ~- Date pete and cursor reburmed €4.3.5. 4.3.63 


adhe sone ose cose ose cone edhe cose ache cose adhe ones adhe cose ashe even othe cone ocho 
BIZ LSI SL4alapet 11a 
adhe sone ose sone ose cnne edhe cose ache cose adhe cose adhe cose ashe eves edhe cnee edhe 


1oiidto0060 0 0 6 Get Charecter from KEFSO at cursor Cand advance) 


4,353.4 Get Date Commend ~- Date oyte returned €4,3.53 
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4,9.5 Received Data - Normal Communication Mode 
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0 Kk K eR KR MOR KO Character from Sereen or He. Cursor if requested 
4.35.4 Received Cursor - Normal Communication Mode 
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Note - when "Horisontal Cursor Position Greater Than $4F" bute is 
received, the computer may obtain the aetual value with the “Request 
Horizontal Cursor from XEPSO" command. 
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Appercdis & Application Notes 


Ld) Charecters may be printed over EGLs in the right margin column without 
causing insert lines to occur by settling the right margin at least one more 
coluenm to the right. 


2) The firmware of the KEFPSGO 1. 3 juetb under @K of the available address 
apace - thus allowing rom replacements to incorporate additional features. 

3) Debug mode allows reading of the parallel port so with the addition of 
@ lateh om the XEPSO board the port becomes bidirectional. 


* 


4) If large text gsecreen (areater than 80 columns wide? nmeecs to be erased 
wee cthe Fill KEPSO0 RAM with EQL command rather than the Clear Sereen char. 


Clear Sereen only clears the current $0 column 24 line nigh window. 


Lis 
whenever 2 50 


> xX Curgor > $4F is handled by the handler. The handler automatics 
senda the Request Horizontal Cursor command to the XEPE 
curgar X value is returned. 


80 RAM 


6) When usine the XEPSO Internal Character Set issue the Fill x 
With Space command to blank the screen. However, when sending characters to 
tne XEFSO sereen, either precede each one with am ESC character or seb the 
LIST flee so that sereen edits do mot occur. 


7) Graphics 8 screen cumps will require e short discussion. Since the OS 
requires 8K RAM to set oup @ mode § sereen the handler cannot reside in its 
abandarcd address space. Am appended AUTORUN.SYS file must first set the 
MEMTOFP pointer to 8K below the top of RAM Ccheck acbual mode 8 valued. Then 
the relocater will move the handler below this point. After entering 40 col 
mode cbhe GRAFHICS § call may be made. Flotting ete. to the sereen is through 
the mormal St interface of the OS. When done the application will 2b KEP OO 
Mode bLnen seb XEFPSO graphics, then reac from the ANTICO sereen RAM ame oubpurt 
to tne XEFSO. 


8) Changing default printer configuration at boot time is shown by disk 
prooram FRINTER. EAS on the system diskette. 
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File Format 


DOS Load File 


Start Acdcdress=-#3000 


Ene Aadcdredacs 


Relocater 
Code 
Handler Leanatin 
JSR 
for 
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Tnebrucbhion 
DOSIANY set 
Relocater 


JME 
bo 
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Tnebrucbhion 
INTT code 
by Relocater 


Printer Aux pybed 


XEFP 80 Handler 
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Relocating Format 
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Relocating Format of 


a a a ee ee ee Se 


Handler 


Handler 


to first 
Dy be 


Link byte 
Relocate 
Valid 


6502 Code 


Byte bo relocate 
acid offset 

Limk pbybe bo second 
Relocate byte 


Hien 


Valid 4502 Code 


High Bete to relocate 
acd offset 

Example Link of 0 
following byte is 

High bude to relocate 


Cage 80 
skip LZ? dake 
then treat byte 
as othe mext Link 


Special MOS 
ey bes 


128 
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Valid 4502 Code 
Relocate 
Lairdes 


FF meas 


bythe bo 
Lo madrrbadie 

Special Case 
end of File 


Duimiety 


Appercdis C Contents of Svatem Diskette 


DOS 2.5 


AUTORUN. SYS XEPSO Relocater and Handler 
KEP SO. BOC This Document 
XEPSOHAN. SRE Handler in assemble source 


RELOOG. SEC Relocater in assemble source 
MAKER. GAS Froaram to generate ALITORUN. SYS 


Exanples for Owners Marual 


WINDOW. EAE 
bs AE 


%. 
3 
%. 
3 


(GHT Ys BA 
PRINTER. BAS 
GRAPHICS. BAS 


DEMO O. GAS Demonstration program for XEFSO 
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